home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 10 / The PC-Sig Library - Shareware for the IBM PC and Compatibles (PC-SIG)(Tenth Edition Disks 1-2804)(1991).iso / PC_SIGCD / 20 / 5 / DISK2051.ZIP / TAPDOC.EXE / TAPDOC.9 < prev    next >
Text File  |  1990-09-28  |  16KB  |  446 lines
  1.  
  2. Section 9 -- Other TAPCIS Features
  3.  
  4.  
  5. Time/Charges  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9-1
  6.  
  7. Multiple Parameter Files    . . . . . . . . . . . . . . . . . . . . . . .  9-2
  8.  
  9. Script Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9-3
  10.    Login Scripts  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9-4
  11.    Weather Script . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9-5
  12.    Upload Script  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9-5
  13.  
  14. Macros  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9-7
  15.  
  16.  
  17. TAPCIS(tm) Documentation Copyright (c) 1990, Support Group, Inc.
  18. 800-USA-GROUP, 301-387-4500
  19.  
  20. ========================================================================
  21. Time/Charges
  22. ========================================================================
  23.  
  24. The external accounting module can generate the usage statistics provided you
  25. have selected to Log Times on the <P>arameters screen. Press <$> from the main
  26. menu to start the time/charges function. You're first asked whether you want
  27. to change the rates. The default rates are those for use with a CompuServe
  28. network phone number. Rates are subject to change. Use <I>nteractive and GO
  29. RATES to obtain the current schedule.
  30.  
  31. If you are using an alternative connection or pay metered local service,
  32. change the rates to reflect those charges. Prime time is the day time rate.
  33. Standard time is evening and weekend. CompuServe keeps its own time record
  34. which you can access with the command GO BILLING. It is not detailed by forum
  35. as are the TAPCIS statistics.
  36.  
  37. Output appears only on the screen. You can use <PrtSc> to print each screen.
  38.  
  39. You can run the STATS.EXE program from DOS if you do not have sufficient
  40. memory to run it from within TAPCIS. You should run it from the same directory
  41. that store your parameter file (PARAMS.CIS) and time log files (LOGmm-yy.CIS,
  42. where mm is the month and yy is the year).
  43.  
  44. STATS will estimate what your bill will be at the end of the month. Do not put
  45. too much stock in this since your usage will probably vary over the rest of
  46. the month-higher or lower. Also, TAPCIS does not know about surcharged
  47. services like Official Airline Guide, Executive News Service, or IQuest. Those
  48. charges will be in addition to the charges recorded by TAPCIS.
  49.  
  50. There are two categories that TAPCIS uses to record charges for
  51. "miscellaneous" usage. The OVERHEAD charge is for the time it takes to
  52. navigate from forum to forum and to login and logout. It also includes the
  53. "rounding" expense since CompuServe charges to the nearest minute.
  54.  
  55. TERMINAL charges are for all time spent interactive regardless of where that
  56. time is spent. Once you are interactive, you can freely navigate from place to
  57. place. TAPCIS logs all that time as a TERMINAL expense in the accounting.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79. TAPCIS                                            Other TAPCIS Features    9-1
  80.  
  81. ========================================================================
  82. Multiple Parameter Files  
  83. ========================================================================
  84.  
  85. TAPCIS supports multiple PARAMS files. You use the <Alt-F> command from the
  86. main menu or forums selection screen. TAPCIS will show you information about
  87. your current PARAMS file and let you switch files or create a clone of the
  88. current one by pressing X. The name of the new file can be 1-3 letters or
  89. numbers. 
  90.  
  91. Each PARAMS.* file contains not only the list of forums but also your user ID,
  92. password, and all other settings from the P>arameters screen. Be sure to set
  93. up the main PARAMS.CIS file with your registration number, user id, and
  94. password and then use <Alt-F> and the <X> copy option to create new ones.
  95.  
  96. You can use an alternate PARAMS file to change forum sets, support more than
  97. 20 selected forums, or switch COM ports and modem for laptop use. For example,
  98. I have a PARAMS.WP that has the two WPSG forums selected and that uses a
  99. different storage and download path than my "normal" PARAMS.CIS (the default
  100. name).
  101.  
  102. You can select the PARAMS file directly from the command line by enclosing it
  103. in parentheses. If you use any other command line options, separate those from
  104. the PARAMS extension with a space:
  105.  
  106. TAPCIS (WP) GNX
  107.  
  108. The above would start TAPCIS using the PARAMS.WP file, globally capture
  109. everything that happens online to the file ONLINE.LOG, execute the <N>ew
  110. command as soon as TAPCIS is loaded, and exit TAPCIS as soon as <N>ew
  111. completes.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140. 9-2    Other TAPCIS Features                                            TAPCIS
  141.  
  142. ========================================================================
  143. Script Language
  144. ========================================================================
  145.  
  146. The script language has three primary uses in TAPCIS:  customizing login
  147. scripts for access through non-CompuServe networks (e.g., Sprintnet, Tymnet,
  148. LATA networks, foreign networks), creating a FRONTEND.SCR to capture
  149. information like weather and the daily news to the CompuServe Mail message
  150. file, and simplifying the repetitive entry of commands in non-forum online
  151. services (e.g., stock portfolio analysis, weather radar map downloading, stock
  152. quotes).
  153.  
  154. The script commands are as follows. Each is a single capital letter or
  155. semicolon for comments. Most commands are followed by a space which delimits
  156. the commands from the parameter.
  157.  
  158.  
  159. ;                             Comment lines begin with a semi-colon and can
  160.                               appear anywhere in the script.
  161.  
  162. B                             Send a break signal. Used in login scripts where
  163.                               a <break> is needed to get the network's
  164.                               attention.
  165.  
  166. C d:\path\filename.ext        Capture output and append it to "filename.ext"
  167.                               on drive "d:" in directory "path." Includes an
  168.                               explicit C Y (see below).
  169.  
  170. C Y                           Start (or restart) the capturing to the file
  171.                               specified with the last C filename script
  172.                               command or to the MAIL.MSG if in FRONTEND.SCR.
  173.  
  174. C N                           Stop capturing output to the file.
  175.  
  176. E                             Comment lines that display on the user's screen
  177.                               as the script executes. They are not sent to
  178.                               CompuServe or saved to any of the files.
  179.  
  180. I                             Input from the keyboard until the user presses
  181.                               <F7>. This script command is useful in login
  182.                               scripts to allow the user to manually get
  183.                               connected to CompuServe. In interactive scripts
  184.                               it can be used to allow the user to select a
  185.                               particular menu choice after the script
  186.                               automatically navigates to the menu. Output is
  187.                               saved to the ONLINE.LOG if the G command line
  188.                               option is used or to the capture file if one is
  189.                               active. Note that TAPCIS will not time out and
  190.                               logoff during the I script command.
  191.  
  192. K d:\path\filename.ext        Kill (delete) the file "d:\path\filename.ext".
  193.                               If you have a script that uses the capture
  194.                               command, and want to remove the old capture if
  195.                               one exists, use the K command before the C
  196.                               script command.
  197.  
  198.  
  199.  
  200.  
  201. TAPCIS                                            Other TAPCIS Features    9-3
  202.  
  203. N                             Sends your name from the parameters screen. Used
  204.                               in the <Alt-P> script.
  205.  
  206. P nn                          Pause for "nn" seconds
  207.  
  208. S text                        Send "text" of any length. Most commands on most
  209.                               services must be followed by an <Enter>. In
  210.                               these cases end the "S " command with caret-M
  211.                               <^> <M>. The caret key can be combined with any
  212.                               alphabetic key to duplicate a control code. For
  213.                               example, ^C is ctrl-C. Control codes must be in
  214.                               uppercase! This command waits for an echo of
  215.                               what is sent before continuing.
  216.  
  217. U text                        This command also sends "text" of any length.
  218.                               However, it does not wait for an echo of the
  219.                               characters sent before continuing. This is
  220.                               useful for login scripts to networks where the
  221.                               first few characters sent may not echo or echo
  222.                               correctly.
  223.  
  224. W x                           Wait for a single character "x" before
  225.                               continuing.
  226.  
  227. W xxxx                        Wait for a four character sequence "xxxx" before
  228.                               continuing. Use a full four characters. Using 2-
  229.                               3 may cause the script to fail.
  230.  
  231. X                             Same as C N. You should start using C N instead
  232.                               of X.
  233.  
  234. ------------------------------------
  235. Login Scripts
  236.  
  237. You can have a user defined login script by putting an underscore < _ > after
  238. the phone number on the <P>arameters screen. An underscore alone tells TAPCIS
  239. to use the script in TAPCIS.SCR. You can put the script filename (without the
  240. extension) after the underscore to use a specific script (i.e., 555-
  241. 1212_MYSCRIPT). If you are going to write your own scripts, you should look at
  242. supplied scripts as an example of how to put one together. Scripts must be in
  243. ASCII format. Here is a simple script for login through a CompuServe node.
  244.  
  245. ; CIS.SCR  -- Login using <CR> for Picky PADs that don't like ^C's.
  246. ; 5.3 version 9/15/90 -rpw
  247. E TAPCIS LOGIN SCRIPT
  248. E Login Through CompuServe Node where ^C is not being recognized
  249. P 3
  250. U ^M
  251. W ame:
  252. S CIS^M
  253.  
  254. A script for a standard LATA Network (usually run by your local phone company)
  255. has been provided in the file LATANET.SCR. You select this script by placing a
  256. colon <:> after the phone number. One problem: LATA Networks are not standard! 
  257. If you are going to use a LATA network, you may have to modify the supplied
  258. script to work with the connect sequence required by your LATANet.
  259.  
  260.  
  261.  
  262. 9-4    Other TAPCIS Features                                            TAPCIS
  263.  
  264. Many non-CompuServe networks require that you start TAPCIS with the P command
  265. line option. When in doubt, you can use the P option with any network without
  266. causing any problems.
  267.  
  268. ------------------------------------
  269. Weather Script
  270.  
  271. Here is a script that will capture today's weather in the file TODAY.WEA. It
  272. deletes the old copy of the file before capturing the new information:
  273.  
  274.  
  275.  
  276.  
  277. ; WEA.SCR - Capture today's weather to TODAY.WEA 
  278. ; 
  279. ; To invoke the script, go online to CIS <Interactive>, make sure you're on a 
  280. ; CompuServe prompt (like in the forums, or at a CIS menu). If in doubt, 
  281. ; type GO CIS, then press <PgUp> then type WEA and press return 
  282. ; 
  283. ; Send the WEAther command.
  284. ; If you want the weather at a different city that has weather reporting, 
  285. ; type the full city and state after WEA
  286. S WEA Columbus, OH^M 
  287. ; Kill the old weather report 
  288. K TODAY.WEA 
  289. ; Open the capture file 
  290. C TODAY.WEA 
  291. ; Wait for the next prompt 
  292. W !
  293. ; Close the capture file 
  294. C N
  295. ; Send carriage return to get back to prompt 
  296. S ^M 
  297.  
  298. ------------------------------------
  299. Upload Script
  300.  
  301. Here is a simple script which uploads a file to a LIB. You should use caution
  302. when writing and testing such scripts!  As you can see the upload script is
  303. really just a sequence of send a command and wait for the next prompt. You can
  304. invoke such a script from within a forum by pressing <PgUp> followed by the
  305. name of the file. Your script file must have a file extension .SCR.
  306.  
  307. ; UPL.SCR -- Upload a file to a forum library. Version 5.3 01/15/89 RPW 
  308. ; 
  309. ; Instructions for use: 
  310. ;    Change the forum name, library number, file name in the UPL command, 
  311. ;    filename on your computer, the file description (keep it fewer than 
  312. ;    465 characters), and the keywords. 
  313. ; Forum to receive the file (change!): 
  314. S G TAPCIS^M 
  315. ; Wait for Forum ! prompt 
  316. W um ! 
  317. ; 
  318. ; Library to receive the file (change!): 
  319. S LIB 2^M 
  320. W ! 
  321.  
  322.  
  323. TAPCIS                                            Other TAPCIS Features    9-5
  324.  
  325. ; 
  326. ; Filename to use on CompuServe (change!) 
  327. ; and file type (ASC or BIN -- change!): 
  328. S UPL UPL.SCR/PRO:B/TYP:ASC^M 
  329. W ter: 
  330. ; 
  331. ; Filename on your computer including path if necessary (change!) 
  332. S UPL.SCR^M 
  333. ; Upload takes place here. Then wait for 'finished:'
  334. W hed:
  335. ; 
  336. ; File description (change!). Be sure to keep the ^M's at the end of lines! 
  337. S In a circular sort of way, this is a file that was uploaded using^M 
  338. S itself. UPL.SCR will permit you to upload any file anywhere on^M 
  339. S CompuServe. Edit it so that the Lib and Forums are correct and then^M 
  340. S go online <I>nteractive selecting no Forum. At the first prompt,^M 
  341. S hit <PgUp> and then enter UPL. Two rules -- 465 char max and no^M 
  342. S blank lines in this DES area.^M 
  343. ; 
  344. ; Exit the description 
  345. S /EXIT^M 
  346. ; Keywords:
  347. W rds: 
  348. ; 
  349. ; Keywords for the file (change!) 
  350. S UPLOAD SCRIPT UPL.SCR TAPCIS^M 
  351. ; Title:
  352. W tle:
  353. S This is the title^M
  354. ; next line is <space>N)? in 'Is this okay (Y or N)?'
  355. W  N)? 
  356. S Y^M 
  357. W ! 
  358. ; Logoff 
  359. S OFF^M
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384. 9-6    Other TAPCIS Features                                            TAPCIS
  385.  
  386. ========================================================================
  387. Macros
  388. ========================================================================
  389.  
  390. TAPCIS supports 40 macros, 20 when online interactive and 20 when editing in
  391. the message editor. You can define the macros by pressing <Alt-M> from the
  392. main menu and selecting either <E>ditor or <O>nline macros. 
  393.  
  394. Next press the letter you want to assign to your macros (A through T only) and
  395. enter the text for the macro. Use the vertical bar (|) for carriage returns.
  396. No other special control codes are supported (e.g., no tabs).
  397.  
  398. Then when in the editor or online, press <Alt-M>. A list of the macros will
  399. appear. Press the corresponding letter and your macro will be passed to the
  400. editor or CompuServe.
  401.  
  402. Note that when online, two macros have been programmed specifically to help
  403. you use CompuServe interactively. <Alt-M> <X> sets CompuServe to verbose menu
  404. mode with a screen size of 23 lines. <Alt-M> <Y> sets an individual forum to
  405. menu mode and pausing after each message. Both these macros affect only the
  406. current session. Macros are not available offline except in the editor. 
  407.  
  408. You can use macros for your standard closing for a message in the editor, or
  409. for conference or CompuServe commands when in interactive mode. In Conference
  410. Mode you can have a macro that would get a list of participants by defining it
  411. as:  /UST||  Notice there are two carriage return characters (||) after the
  412. command. That is so that when the macro is invoked from the Conference Mode
  413. input buffer at the bottom of the screen that the command will be sent on to
  414. CompuServe (two returns are required).
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445. TAPCIS                                            Other TAPCIS Features    9-7
  446.